Класс DbConnectionStringBuilder
Класс DbConnectionStringBuilder
предназначен для создания и управления содержимым строк подключения, которые используются классом DbConnection
.
Класс DbConnectionStringBuilder
предоставляет ограниченный внутренний набор пар «ключ/значение». Если в строке подключения отсутствует значение какого-либо параметра, то в процессе соединения с ЛИНТЕР-сервером используется значение по умолчанию. При извлечении свойства ConnectionString того или иного объекта строка содержит только такие пары «ключ/значение», в которых «значение» отличается от стандартного значения.
Ключи строки подключения:
-
DataSource=< имя сервера >;
-
User ID=< имя пользователя >;
-
Password=< пароль >;
-
Persist Security Info=< аутентификации >;
-
IsolationLevel=< уровень изоляции >;
-
Autocommit=< режим канала >;
-
Minimum Pool Size=< число >;
-
Maximum Pool Size=< число >;
-
ConnectionTimeout=< число >;
-
Channel Priority=< число >;
-
Messages Language=< язык сообщений >;
-
Charset=< кодировка >.
Формат строки подключения приведён в подпункте «ConnectionString».
Конструкторы класса DbConnectionStringBuilder
приведены в таблице 37.
Конструктор | Описание |
---|---|
LinterDbConnectionStringBuilder | Создает новый экземпляр класса LinterDbConnectionStringBuilder с параметрами соединения по умолчанию. |
LinterDbConnectionStringBuilder(String) | Создает новый экземпляр класса LinterDbConnectionStringBuilder на основе заданной строки подключения. |
Свойства класса DbConnectionStringBuilder
приведены в таблице 38.
Свойство | Описание |
---|---|
BrowsableConnectionString | Предоставляет/устанавливает видимость свойства ConnectionString в конструкторах. |
ConnectionString | Предоставляет/устанавливает строку подключения, связанную с DbConnectionStringBuilder. |
Count | Предоставляет текущее количество ключей, содержащихся в строке подключения. |
DataSource | Предоставляет/устанавливает имя сервера источника данных, к которому осуществляется подключение. |
IsFixedSize | Предоставляет информацию о возможности добавления новых ключей в строку подключения. |
IsReadOnly | Предоставляет информацию о возможности изменения объекта LinterDbConnectionStringBuilder (т.е. является коллекция «только для чтения» или нет). |
Item | Предоставляет/устанавливает значение заданного ключа строки подключения. |
Keys | Предоставляет список ключей, задействованных в строке подключения. |
Password | Предоставляет/устанавливает пароль текущего пользователя БД источника данных. |
PersistSecurityInfo | Предоставляет или устанавливает режим отображения пароля в строке подключения. |
UserID | Предоставляет/устанавливает имя пользователя, которое должно использоваться при подключении к серверу источника данных. |
Values | Предоставляет массив значений всех ключей текущей строки подключения. |
Методы класса DbConnectionStringBuilder
приведены в таблице 39.
Метод | Описание |
---|---|
Add
| Добавляет параметр подключения (пару «ключ/значение») в текущую строку подключения. |
AppendKeyValuePair(StringBuilder, String, String)
| Добавляет пару «ключ/значение» в массив элементов «ключ/значение» (в объект StringBuilder) |
AppendKeyValuePair(StringBuilder, String, String, Boolean)
| Добавляет элемент «ключ/значение» в указанную строку подключения с заданным разделителем элементов «ключ/значение». |
Clear
| Удаляет содержимое текущей строки подключения. |
ContainsKey
| Проверяет поддержку ADO.NET-провайдером в строке подключения указанного ключа. |
EquivalentTo
| Сравнивает две строки подключения. |
Remove
| Удаляет элемент «ключ/значение» из строки подключения. |
ShouldSerialize
| Проверяет наличие указанного ключа в строке подключения. |
TryGetValue
| Предоставляет значение указанного ключа строки подключения. |